home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #2 / Monster Media No. 2 (Monster Media)(1994).ISO / utils2 / mdr24a.zip / README24 < prev   
Text File  |  1994-05-30  |  16KB  |  239 lines
  1.  
  2.                FASTMINDER INTERFACE 2.4 INSTALLATION INSTRUCTIONS
  3.                FOR USE WITH IBM AND IBM-COMPATIBLE COMPUTERS ONLY
  4.                ──────────────────────────────────────────────────
  5.                Absolutely essential:  80286-based computer system
  6.                Strongly recommended:  12MHz or higher clock speed
  7.                ──────────────────────────────────────────────────
  8.                NOTICE! THE CHARACTER REPRESENTING THE REPLACEABLE
  9.                PARAMETER HAS CHANGED; SEE VERSION 2.4 INFORMATION
  10.  
  11.   ───────────────────────────────────────────────────────────────────────────
  12.   INTRODUCTORY INFORMATION ──────────────────────────────────────────────────
  13.   ───────────────────────────────────────────────────────────────────────────
  14.        This key-driven programmable interface does not come with an automatic
  15.   installation system since installation requires copying just two files from
  16.   the diskette to the hard drive. The user should put the MINDER.DAT datafile
  17.   in the MAIN DIRECTORY of the hard drive because that is where the interface
  18.   will be looking for it. The actual MINDER.EXE program may be located in any
  19.   directory on the hard drive. The default drive for writing the datafile and
  20.   for executing the stored command strings is now USER-SELECTABLE through the
  21.   INSERT key, though the program still begins and exits in the root directory.
  22.   Datafiles are read from the LAUNCH drive and written to whichever drive has
  23.   been specified as the default when the program terminates
  24.  
  25.        After the interface files have been installed, the user should execute
  26.   the program and press THE PLUS KEY to invoke the help section. This section
  27.   should be looked at carefully since it explains the overall organization of
  28.   the interface and how the different features are accessed. For example, the
  29.   semicolon (;) key has CHANGED ITS FUNCTION again; please read the paragraph
  30.   about the key. The help section's warning about direct editing of datafiles
  31.   has vanished, but still applies. Users should not edit these files directly
  32.   because their unique formatting cannot be disturbed without destroying them
  33.   Users should remember that this program functions ONLY with these datafiles
  34.  
  35.   ───────────────────────────────────────────────────────────────────────────
  36.   VERSION 2.0 INFORMATION ───────────────────────────────────────────────────
  37.   ───────────────────────────────────────────────────────────────────────────
  38.        Version 2.0 incorporates a REPLACEABLE PARAMETER, which should greatly
  39.   enhance the interface's utility for those individuals with several programs
  40.   that require the filename specification in the middle of the command string
  41.   rather than at the end. The parameter should even be useful for persons who
  42.   automate common tasks by creating single-line, single-parameter batch files
  43.   The inclusion of the replaceable parameter was made possible by Mr. William
  44.   Smith, whose informative article "An Essential String Function Library" was
  45.   published in the January 1993 issue of -The C Users Journal-
  46.  
  47.        Version 2.0 offers AUTOMATED KEY SORTING, which replaces the primitive
  48.   copy function provided in earlier releases. This automated sorting function
  49.   works with single page copying only, and operates like this: the source key
  50.   settings are copied to the target key and all other settings (including the
  51.   target key's original settings) are moved forward or backward to compensate
  52.   Automated sorting does not apply, however, when copying key settings across
  53.   pages; that function remains unchanged (the source key information destroys
  54.   the target key information without changing the settings of any other keys)
  55.  
  56.        Finally, Version 2.0 offers users the possibility of reading ALTERNATE
  57.   DATAFILES either from the command line or from within the program. Datafile
  58.   names start with 'minder' and are selected by entering the file's extension
  59.   Extensions may be entered from the command line (C:\> minder ann) or inside
  60.   the interface by pressing the apostrophe key, adjacent to the semicolon key
  61.   The apostrophe key initiates the datafile loading sequence, which begins by
  62.   asking if the currently loaded file should be stored or discarded. Then the
  63.   prompt for the new datafile will appear, UNLESS the original datafile could
  64.   not be stored properly. When this prompt for the new datafile appears, just
  65.   enter the extension of the datafile you want (remembering that the datafile
  66.   must reside in the ROOT directory). This should be useful for multiple user
  67.   environments, power users running hundreds of applications, and persons who
  68.   like to change program colors often. NOTICE: pressing ENTER at the datafile
  69.   selection prompt or executing the program without arguments defaults to the
  70.   'minder.dat' datafile. Press the space bar and ENTER at the datafile prompt
  71.   if you want to load the datafile 'minder' with no extension (this cannot be
  72.   done from the command line)
  73.  
  74.        When changing datafiles from within the program, users should be aware
  75.   that the current directory will change to the root directory, the directory
  76.   key window will become the active window (the one subject to scrolling) and
  77.   both the directory key and operation key windows will be reset to page zero.
  78.   In addition, the key-lock status and the key-lock codeword will reflect the
  79.   settings of the datafile being loaded. THE AUTOMATIC OPTION SETTING, THOUGH,
  80.   WILL NOT BE RESET but instead will remain constant across multiple datafile
  81.   loading sequences. This preservation of the automatic option setting, while
  82.   not intended, may nonetheless prove useful to persons who use the automatic
  83.   option capability frequently. This programming oversight is therefore being
  84.   retained in version 2.4A and might very well be retained in future releases
  85.  
  86.   ───────────────────────────────────────────────────────────────────────────
  87.   REPLACEABLE PARAMETERS ────────────────────────────────────────────────────
  88.   ───────────────────────────────────────────────────────────────────────────
  89.        In versions 1.2 through 1.4 of the program, pressing any alphabetic or
  90.   numeric key would generate an information-window prompt, requesting command
  91.   arguments. The arguments would be tacked onto the end of the command string
  92.   stored inside the datafile. When automatic mode had been activated, however
  93.   the program would execute the specified option string automatically without
  94.   requesting arguments. VERSION 2.0 OPERATES DIFFERENTLY. This version allows
  95.   users to place a single replaceable parameter in each stored command string
  96.   The replaceable parameter (indicated by the percent sign WITHOUT any number 
  97.   following it) marks the position in the command string at which any command
  98.   arguments entered at the prompt will be inserted. Only one parameter may be
  99.   placed into any command string; if multiple parameters are found, the first
  100.   parameter will be used to determine the position at which command arguments
  101.   are inserted
  102.  
  103.         Because of this added feature, the interface now operates differently
  104.   whenever the alphanumeric keys are pressed. If the command string requested
  105.   by that keypress has a replaceable parameter, the information-window prompt
  106.   for the command arguments will appear. Conversely, if the command string is
  107.   lacking a replaceable parameter, the command will be EXECUTED AUTOMATICALLY
  108.   This method of operation (argument prompts for strings with parameters, and 
  109.   automatic execution for strings without parameters) also works for function
  110.   keys whenever automatic mode has been set. With auto mode set, the pressing
  111.   of directory keys will generate AN ARGUMENTS PROMPT if the automatic option
  112.   string contains a replaceable parameter. If the automatic option string has
  113.   no parameter, however, it will execute automatically. Users should remember
  114.   that ANY PERCENT SIGN in the command string will be seen as a parameter and
  115.   treated as such by the program. Users should also be careful when selecting
  116.   arguments for automatic option commands since these commands will change if
  117.   the operation page changes
  118.  
  119.   ───────────────────────────────────────────────────────────────────────────
  120.   VERSION 2.2 INFORMATION ───────────────────────────────────────────────────
  121.   ───────────────────────────────────────────────────────────────────────────
  122.        Version 2.2 makes it possible to replace multiple parameters in stored
  123.   command strings; the first five parameters may be replaced by user-supplied
  124.   arguments. Because parameters remain unnumbered, a command arguments prompt
  125.   is generated for EACH parameter (through the fifth) found within the stored
  126.   command string. For example, the stored operation key  cl %.c %.obj > %.err
  127.   would generate three separate argument prompts, although parameters one and  
  128.   three might represent the same (expanded) filename. Users wishing to expand
  129.   several parameters similarly should note that the F3 key functions the same
  130.   at string prompts as it does at the DOS command line; it recalls the string
  131.   entered immediately prior to the current prompt. Unfortunately, this cannot
  132.   be used to recall strings that were entered several prompts ago; users will
  133.   have to retype such strings manually. Finally, Version 2.2 offers users the
  134.   ability to blank their screens by pressing the back-slash key; this feature
  135.   might prove helpful to people who receive phone calls during computer hours
  136.  
  137.   ───────────────────────────────────────────────────────────────────────────
  138.   VERSION 2.3 INFORMATION ───────────────────────────────────────────────────
  139.   ───────────────────────────────────────────────────────────────────────────
  140.        Version 2.3 allows users to select the default drive for the operation
  141.   strings and for writing the datafile. Upon entering the program the default
  142.   drive will remain the LAUNCH drive; the drive will not be reset to drive C:
  143.   until the user selects drive C: with the INSERT key. Pressing that key will
  144.   generate a prompt requesting a drive letter from A to Z (even if the user's
  145.   computer does not have that many drives). Press the letter that corresponds
  146.   to the drive you want to have as your default drive. Pressing the space bar
  147.   will report the current default directory for the current default drive, as
  148.   in previous versions. Version 2.3 also contains better handling of diskette
  149.   drive errors (like those encountered when the drive is accessed but nothing
  150.   has been placed inside it for reading). These error handling routines might
  151.   not function correctly under all circumstances; I was only able to test for
  152.   missing diskettes and not for other types of diskette errors. Please do not
  153.   hesitate to report problems with these routines; I will try to fix whatever
  154.   bugs are found to the best of my (meager) abilities
  155.  
  156.   ───────────────────────────────────────────────────────────────────────────
  157.   VERSION 2.4 INFORMATION ───────────────────────────────────────────────────
  158.   ───────────────────────────────────────────────────────────────────────────
  159.        Version 2.4 offers greatly-improved handling of string input, which is
  160.   due entirely to the use of the C source code in EDITGETS.C, one of the many
  161.   public domain programs contained in Snippets and available for download via
  162.   CompuServe. I had originally intended to use another example of source code
  163.   for string input, but EDITGETS.C is about one-third the size of the routine
  164.   initially considered for this purpose. For some time I have wanted to learn
  165.   how to handle string input competently, and EDITGETS.C appears to "fill the
  166.   bill" to perfection, adding very little overhead to the program. The source
  167.   credits for EDITGETS.C are shown below:
  168.  
  169.   /* editgets.c - line input w/editing                                     */
  170.   /* this code is released to the public domain                            */
  171.   /* written by Jon Burchmore                                              */
  172.   /* modifications & enhancements by Bob Stout                             */
  173.  
  174.   Because EDITGETS.C is invoked for all string input, the behavior of certain
  175.   functions (most notably the codeword routines) has changed. Previously, the
  176.   codeword routines were extremely primitive, letting users neither leave nor
  177.   correct errors. With this new release, the codeword routines work more like
  178.   regular string inputs, excepting of course the screen display. Also, please
  179.   be aware that a default codeword ("fastdata") will be created when the user
  180.   presses ENTER alone at the create codeword prompt. This was done to prevent
  181.   empty codeword strings from being written into the datafile. Pressing ENTER
  182.   alone at the reenter codeword prompt is equivalent to typing "fastdata" and
  183.   will clear the default codeword
  184.  
  185.   Apart from this long overdue improvement, there is only one other change of
  186.   real importance in the program. The replaceable parameter, once represented
  187.   by the '%' character, has been changed to the '$' character. This change is
  188.   potentially quite significant, because it permits the storing and execution
  189.   of DOS commands that themselves require the '%' character. For example:
  190.  
  191.   C:\> for %f in (visual borland watcom) do mkdir %f
  192.   
  193.   This command could be stored as 'for %f in ($) do mkdir %f', thus prompting
  194.   the user only once for all three elements or alternately could be stored as
  195.   'for %f in ($ $ $) do mkdir %f', which would give three prompts to the user.
  196.   Obviously, this example represents merely the tip of the proverbial iceberg
  197.   but should be enough to demonstrate at least some of the potential benefits
  198.   associated with this change
  199.  
  200.   ───────────────────────────────────────────────────────────────────────────
  201.   REGISTRATION INFORMATION ──────────────────────────────────────────────────
  202.   ───────────────────────────────────────────────────────────────────────────
  203.        FASTMINDER version 2.4 is public domain software; there are absolutely
  204.   no restrictions of any kind governing its duplication, distribution, or use
  205.   Users are nonetheless urged to report any errors they encounter while using
  206.   the software and are encouraged to share their opinions about the interface
  207.   design with the programmer. Postcards remain the preferred vehicle for user
  208.   feedback and should be mailed to the postal service address displayed below.
  209.   Also, please distribute this program and its documentation in original form
  210.  
  211.        Version 2.4 was developed and compiled with the following packages:
  212.  
  213.        COMPUTER:  FastMicro FastData ValueLine 486SX-25, Super VGA Color
  214.                   This is the very same $999 system John Dvorak cited in
  215.                   his "1993 minimum machine" PC Magazine column (the one
  216.                   featured in the PC Magazine issue on the Pentium chip)
  217.  
  218.         EDITORS:  Video Display Editor 1.65 + Programmer's Workbench 2.1
  219.                   Because of its ergonomic qualities, VDE constitutes an
  220.                   outstanding development environment, while Microsoft's
  221.                   PWB is helpful for fast prototyping and spot revisions
  222.  
  223.        COMPILER:  Microsoft (R) C/C++ Optimizing Compiler Version 7.00
  224.         options:  /Bm4096 /Gry2 /Ozaxb2 /W4 minder.c txtonly.obj
  225.  
  226.          LINKER:  Microsoft (R) Segmented Executable Linker Version 5.31
  227.         options:  /exepack /farcall /noe /noi /packc /packf graphics.lib
  228.  
  229.   Version 2.5 is slated to include memory swapping, but this may be postponed
  230.   Other potential features include multiple auto options and block key-moving
  231.   Please send any ideas for new features or enhancements of existing ones to:
  232.  
  233.   Name, Email Address:       Douglas G. Mohn (72124.2713@compuserve.com)
  234.   Post Office Address:       21 Brucester Bridge Court, Catonsville  MD 21228
  235.  
  236.   ───────────────────────────────────────────────────────────────────────────
  237.   END OF FILE ───────────────────────────────────────────────────────────────
  238.   ───────────────────────────────────────────────────────────────────────────
  239.